Skip to content

Retrieve detailed device information.
Stable

Request

Retrieves comprehensive details for a single enrolled device by UUID, using the V2 device schema.

Returns a V2 platform-typed device record with richer fields than the v0 equivalent, for all supported Esper-managed platforms.

About Get Device Details (V2)

This is the recommended endpoint for single-device lookups in new integrations. The V2 device schema provides additional fields compared to the v0 schema and aligns with the richer data model returned by /api/v2/devices/. Like the list endpoint, the response is polymorphic — the exact fields depend on the device platform.

Key Fields

id (path) — Esper device UUID (required)

Common Use Cases

Fetching full device context before constructing a pipeline or operation

Retrieving V2-specific fields like Foundry OS version, Esper agent version, or lock-down state

Integrating device data into external ITSM, asset management, or monitoring systems

Best Practices

Prefer this over /api/device/v0/devices/{id}/ for all new integrations

Inspect the platform field to determine which V2 schema variant applies before parsing

Use the heartbeat endpoints for lightweight connectivity checks rather than polling this endpoint

Security
device_apiKey
Path
idstring, (uuid)required

ID of the device

cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/v2/devices/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Detailed information of the device

Bodyapplication/json
codeinteger
messagestring
contentdevice_AppleDeviceV2 (object) or device_AndroidDeviceV2 (object) or device_LinuxDeviceV2 (object) or device_WindowsDeviceV2 (object)
One of:
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "timezone_string": "America/Los_Angeles",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "alias": "string",
    "os": "iOS",
    "state": 0,
    "platform": "APPLE",
    "serial": "string",
    "os_version": "string",
    "global_device_id": "string",
    "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
    "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",
    "tags": [ … ],
    "hardware_info": { … },
    "software_info": { … },
    "network_info": { … },
    "memory_info": { … },
    "blueprint_info": { … },
    "udid": "string",
    "dep_profile": "string",
    "dep_profile_push_time": "2019-08-24T14:15:22Z",
    "dep_profile_assign_time": "2019-08-24T14:15:22Z",
    "dep_profile_status": "empty",
    "enrolment_info": { … },
    "last_seen": "2019-08-24T14:15:22Z",
    "tokens": { … },
    "is_supervised": true,
    "device_source": "ABM",
    "managed_by": "BLUEPRINT",
    "provisioned_with": "BLUEPRINT",
    "provisioned_on": "2019-08-24T14:15:22Z",
    "is_seamless": true,
    "is_locked_down": true,
    "is_ddm_enabled": true,
    "app_mode_meta": { … },
    "created_by": "string",
    "updated_by": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "memory_stats": { … },
    "battery_stats": { … },
    "updated_at": "2019-08-24T14:15:22Z"
  }
}